'\" te
'\"! tbl|eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp Jan 14 18:30
.ds Dm 01 texcoord.
.ds Xs 3537 4 texcoord.gl
.TH GLTEXCOORD 3G
.SH NAME
.B "glTexCoord1d, glTexCoord1f, glTexCoord1i, glTexCoord1s, glTexCoord2d, glTexCoord2f, glTexCoord2i, glTexCoord2s, glTexCoord3d, glTexCoord3f, glTexCoord3i, glTexCoord3s, glTexCoord4d, glTexCoord4f, glTexCoord4i, glTexCoord4s, glTexCoord1dv, glTexCoord1fv, glTexCoord1iv, glTexCoord1sv, glTexCoord2dv, glTexCoord2fv, glTexCoord2iv, glTexCoord2sv, glTexCoord3dv, glTexCoord3fv, glTexCoord3iv, glTexCoord3sv, glTexCoord4dv, glTexCoord4fv, glTexCoord4iv, glTexCoord4sv
\- set the current texture coordinates

.SH C SPECIFICATION
void \f3glTexCoord1d\fP(
GLdouble \fIs\fP )
.nf
.fi
void \f3glTexCoord1f\fP(
GLfloat \fIs\fP )
.nf
.fi
void \f3glTexCoord1i\fP(
GLint \fIs\fP )
.nf
.fi
void \f3glTexCoord1s\fP(
GLshort \fIs\fP )
.nf
.fi
void \f3glTexCoord2d\fP(
GLdouble \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord2d( 'u
	GLdouble \fIt\fP )
.fi
void \f3glTexCoord2f\fP(
GLfloat \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord2f( 'u
	GLfloat \fIt\fP )
.fi
void \f3glTexCoord2i\fP(
GLint \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord2i( 'u
	GLint \fIt\fP )
.fi
void \f3glTexCoord2s\fP(
GLshort \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord2s( 'u
	GLshort \fIt\fP )
.fi
void \f3glTexCoord3d\fP(
GLdouble \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord3d( 'u
	GLdouble \fIt\fP,
	GLdouble \fIr\fP )
.fi
void \f3glTexCoord3f\fP(
GLfloat \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord3f( 'u
	GLfloat \fIt\fP,
	GLfloat \fIr\fP )
.fi
void \f3glTexCoord3i\fP(
GLint \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord3i( 'u
	GLint \fIt\fP,
	GLint \fIr\fP )
.fi
void \f3glTexCoord3s\fP(
GLshort \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord3s( 'u
	GLshort \fIt\fP,
	GLshort \fIr\fP )
.fi
void \f3glTexCoord4d\fP(
GLdouble \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord4d( 'u
	GLdouble \fIt\fP,
	GLdouble \fIr\fP,
	GLdouble \fIq\fP )
.fi
void \f3glTexCoord4f\fP(
GLfloat \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord4f( 'u
	GLfloat \fIt\fP,
	GLfloat \fIr\fP,
	GLfloat \fIq\fP )
.fi
void \f3glTexCoord4i\fP(
GLint \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord4i( 'u
	GLint \fIt\fP,
	GLint \fIr\fP,
	GLint \fIq\fP )
.fi
void \f3glTexCoord4s\fP(
GLshort \fIs\fP,
.nf
.ta \w'\f3void \fPglTexCoord4s( 'u
	GLshort \fIt\fP,
	GLshort \fIr\fP,
	GLshort \fIq\fP )
.fi

.SH PARAMETERS
.TP \w'\f2s\fP\ \f2t\fP\ \f2r\fP\ \f2q\fP\ \ 'u 
\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP
Specify \f2s\fP, \f2t\fP, \f2r\fP, and \f2q\fP  texture coordinates.
Not all parameters are present in all forms of the command.
.SH C SPECIFICATION
void \f3glTexCoord1dv\fP(
const GLdouble \fI*v\fP )
.nf
.fi
void \f3glTexCoord1fv\fP(
const GLfloat \fI*v\fP )
.nf
.fi
void \f3glTexCoord1iv\fP(
const GLint \fI*v\fP )
.nf
.fi
void \f3glTexCoord1sv\fP(
const GLshort \fI*v\fP )
.nf
.fi
void \f3glTexCoord2dv\fP(
const GLdouble \fI*v\fP )
.nf
.fi
void \f3glTexCoord2fv\fP(
const GLfloat \fI*v\fP )
.nf
.fi
void \f3glTexCoord2iv\fP(
const GLint \fI*v\fP )
.nf
.fi
void \f3glTexCoord2sv\fP(
const GLshort \fI*v\fP )
.nf
.fi
void \f3glTexCoord3dv\fP(
const GLdouble \fI*v\fP )
.nf
.fi
void \f3glTexCoord3fv\fP(
const GLfloat \fI*v\fP )
.nf
.fi
void \f3glTexCoord3iv\fP(
const GLint \fI*v\fP )
.nf
.fi
void \f3glTexCoord3sv\fP(
const GLshort \fI*v\fP )
.nf
.fi
void \f3glTexCoord4dv\fP(
const GLdouble \fI*v\fP )
.nf
.fi
void \f3glTexCoord4fv\fP(
const GLfloat \fI*v\fP )
.nf
.fi
void \f3glTexCoord4iv\fP(
const GLint \fI*v\fP )
.nf
.fi
void \f3glTexCoord4sv\fP(
const GLshort \fI*v\fP )
.nf
.fi

.SH PARAMETERS
.TP
\f2v\fP
Specifies a pointer to an array of one, two, three, or four elements,
which in turn specify the
\f2s\fP,
\f2t\fP,
\f2r\fP, and
\f2q\fP texture coordinates.
.SH DESCRIPTION
\%\f3glTexCoord\fP specifies texture coordinates in
one,
two,
three, or
four dimensions.  
\%\f3glTexCoord1\fP sets the current texture coordinates to
(\f2s\fP, 0, 0, 1);
a call to 
.br
\%\f3glTexCoord2\fP sets them to
(\f2s\fP, \f2t\fP, 0, 1).
.BP
Similarly, \%\f3glTexCoord3\fP specifies the texture coordinates as
(\f2s\fP, \f2t\fP, \f2r\fP, 1), and
\%\f3glTexCoord4\fP defines all four components explicitly as
(\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP). 
.P
The current texture coordinates are part of the data
that is associated with each vertex and with the current
raster position. 
Initially, the values for 
\f2s\fP,
\f2t\fP,
\f2r\fP, and
\f2q\fP
are (0, 0, 0, 1). 
.P
.SH NOTES
The current texture coordinates can be updated at any time.
In particular,
\%\f3glTexCoord\fP can be called between a call to \%\f3glBegin\fP and the corresponding
call to \%\f3glEnd\fP.
.P
When the \%\f3GL_ARB_imaging\fP extension is supported, \%\f3glTexCoord\fP always
updates texture unit \%\f3GL_TEXTURE0_ARB\fP.
.SH ASSOCIATED GETS
\%\f3glGet\fP with argument \%\f3GL_CURRENT_TEXTURE_COORDS\fP
.SH SEE ALSO
\%\f3glTexCoordPointer(3G)\fP,
\%\f3glVertex(3G)\fP
